<?php 
/** 
 * 
 *
 * @package api
 * @subpackage collections
 * @author Richard Fullmer <php-api@byu.edu>
 * 
 * @version 1.0
 */
 
/**
 * Interface Iterable
 * 
 * Implementing this interface allows an object to become the target of a basic java iterator.
 *
 * @package api
 * @subpackage collections
 * @author Richard Fullmer
 */
interface Iterable {	
	/**
	 * Returns an iterator over a set of elements.
	 *
	 * <p>
	 * Returns an iterator over the elements in this collection. There are no guarantees concerning the order in which the 
	 * elements are returned (unless this collection is an instance of some class that provides a guarantee).
	 * </p>
	 *
	 * @returns CollectionIterator an CollectionIterator
	 */
	public function iterator();
}



?>